Rework interactive tutorials - #50347
Merged
BillWagner merged 21 commits intoDec 10, 2025
Merged
Conversation
First edit pass on tuples and types.
First edit pass updating the branches and loops tutorial.
Convert all code from this sample to file-based apps.
BillWagner
force-pushed
the
remove-interactive-tutorials
branch
from
December 5, 2025 16:54
d611b78 to
947157c
Compare
Member
Author
|
This is ready for review, but not ready to merge. I'm waiting on creating the official codespace repo for these introductory tutorials. |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR reimagines the interactive C# tutorials by replacing Try.NET with a GitHub Codespaces-based approach using file-based apps. Instead of running code in an in-browser interactive window, users now create files in GitHub Codespaces and execute them using dotnet commands in a terminal.
Key Changes:
- Migrated all tutorial content from Try.NET interactive snippets to GitHub Codespaces with file-based C# apps
- Consolidated code snippets into single executable .cs files (e.g.,
hello-world.cs,numbers.cs,tuples-types.cs) - Removed project files (.csproj) as tutorials now use file-based apps
- Updated instructions to guide users through creating and running code in Codespaces
Reviewed changes
Copilot reviewed 28 out of 28 changed files in this pull request and generated 14 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/csharp/tour-of-csharp/tutorials/index.md | Updated landing page to reference GitHub Codespaces instead of browser-based interactive experience |
| docs/csharp/tour-of-csharp/tutorials/hello-world.md | Converted from interactive tutorial to Codespaces-based tutorial with file creation and terminal execution instructions |
| docs/csharp/tour-of-csharp/tutorials/numbers-in-csharp.md | Reorganized to use file-based execution with methods; contains typos and duplicate content |
| docs/csharp/tour-of-csharp/tutorials/branches-and-loops.md | Converted to Codespaces approach with code refactoring into methods; has duplicate completion messages |
| docs/csharp/tour-of-csharp/tutorials/list-collection.md | Updated to use Codespaces with file-based execution; outdated description and command issue |
| docs/csharp/tour-of-csharp/tutorials/tuples-and-types.md | Converted to Codespaces format with file-based app approach; missing instructional context |
| docs/csharp/tour-of-csharp/tutorials/pattern-matching.md | Updated to use Codespaces and file-based execution with grammar issue |
| docs/csharp/tour-of-csharp/tutorials/snippets/HelloWorld/hello-world.cs | New consolidated code file replacing Program.cs |
| docs/csharp/tour-of-csharp/tutorials/snippets/NumbersInCsharp/Numbers.cs | Refactored code into multiple methods for better organization |
| docs/csharp/tour-of-csharp/tutorials/snippets/BranchesAndLoops/branches-loops.cs | Added new refactored code section with methods |
| docs/csharp/tour-of-csharp/tutorials/snippets/ListCollection/list.cs | New consolidated code file replacing Program.cs |
| docs/csharp/tour-of-csharp/tutorials/snippets/TuplesAndTypes/tuples-types.cs | New consolidated code file with incorrect variable names in output |
| docs/csharp/tour-of-csharp/tutorials/snippets/PatternMatching/patterns.cs | New consolidated code file replacing multiple separate files |
| *.csproj files | Deleted project files as tutorials now use file-based apps |
| Program.cs files | Removed old Program.cs files, replaced by new consolidated snippet files |
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Rework all the current tutorials to match the current approved style guide.
Member
Author
|
@meaghanlewis These are now ready for a final review pass. I'll start the process to make the tutorial repo public. I'll keep the |
meaghanlewis
approved these changes
Dec 10, 2025
Co-authored-by: Meaghan Osagie (Lewis) <moneikmarie@gmail.com>
BillWagner
commented
Dec 10, 2025
BillWagner
left a comment
BillWagner
left a comment
Member
Author
There was a problem hiding this comment.
Thanks @meaghanlewis
BillWagner
enabled auto-merge (squash)
December 10, 2025 18:23
BillWagner
disabled auto-merge
December 10, 2025 18:25
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #50331
Fixes #50381
Reimagine the interactive tutorials that used Try.NET to introduce developers to the .NET platform.
Based on dotnet/try#1285, instead of Try.NET, use file-based apps in .NET 10 and GitHub codespaces to introduce developers to the platform without requiring an installation.
The current text uses the .NET template for the codespace. That works, but has extra features. A new
(temporarily private)repo is available and referenced in this PR at https://github.com/dotnet/tutorial-codespace.Edit: The template repo is now public.
Internal previews
ifstatements and loops - conditional logic